home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILREEN / PPP.LZH / PPP107.DOC < prev    next >
Text File  |  1988-07-20  |  15KB  |  378 lines
  1.         Programmable Printer PopUp Users Guide
  2.  
  3.  
  4.     (c) Copyright 1987, 1988 Mark Allen Neil, All Rights Reserved
  5.  
  6.                 Revision 1.07
  7.                 2/05/88
  8.  
  9.                 Welcome to PPP-Programmable Printer PopUp
  10.  
  11.  
  12. This program is being distributed as user-supported software.
  13.  
  14. A limited license is granted to all users of this program, to make
  15. copies of this program and distribute them to other users, with the
  16. following conditions :
  17.  
  18. 1. The program is not to be distributed to others in modified form.
  19. 2. No fee is to be charged (or any other consideration received) for
  20.    copying or distributing the program without an express written
  21.    agreement with :
  22.  
  23.     Mark Allen Neil
  24.     5627 Silver Leaf Road
  25.     San Jose, CA  95138
  26.  
  27. You are encouraged to copy and share this program with other users.
  28. If you find this program useful, please consider sending a contribution
  29. of $20.00 to the above address to support future enhancements.  Thanks.
  30.  
  31.  
  32.  
  33. Table Of Contents
  34.  
  35. Section   Contents
  36.  
  37. 1.0      Introduction
  38. 2.0      Features
  39. 2.1      Important files
  40. 2.2      The PPP Main Menu
  41. 2.3      The Help Menu
  42. 2.3.1    The HotKey Menu
  43. 2.3.2    The Printer Selection Menu
  44. 3.0      Command Line Switches
  45. 4.0      Printer Definition Files
  46. 5.0      Acknowledgements
  47.  
  48.  
  49. 1.0  Introduction
  50.  
  51. Programmable Printer PopUp (PPP) is a utility which allows you to send
  52. configuration codes to your printer.  PPP can be loaded as a resident
  53.  
  54. PPP107 Users Guide    --   Page 2
  55.  
  56.  
  57. utility (40 K), or it can be executed from a run-time prompt with command
  58. line parameters.  This document will explain in detail what PPP does, and
  59. how to use it to your advantage.
  60.  
  61. 2.0  Features
  62.  
  63. PPP was designed to be as easy to use as possible.  There are now two or
  64. three printer pop-up programs on the market which have more features, but
  65. there are advantages to a program with fewer features:
  66.  
  67.  - Easier to learn
  68.  - Easier to use
  69.  - 80 % of the "nifty" features are useless from day to day
  70.  - PPP costs less
  71.  
  72.  2.1  Important files
  73.  
  74. There are 2 basic file types which make up the PPP package.  The first is
  75. the PPP executable file, called PPP107.COM.  The other type of files are
  76. called "printer definition files."  Each one of these files has the
  77. extension .PPP, e.g. P321.PPP.  The printer definition files define the
  78. control codes which PPP will send to the printer.  You may have several
  79. printer control files, and you can switch between them at will.
  80.  
  81.  
  82.  2.2  The PPP Main Menu
  83.  
  84. When PPP is invoked, either from a command line or by pressing the
  85. "hotkey," the user is presented with a menu of choices.  This menu consists
  86. of a list of "options" from which the user can select.  Any combination of
  87. options can be selected.  An option is selected by moving the ">" character
  88. up or down to the desired option and pressing the space bar.  Options can
  89. be toggled off and on by pressing the space bar repeatedly.  An option is
  90. "selected" when it appears in reverse video.
  91.  
  92. An "option" is something you would like to tell the printer to do.  For
  93. example, turning on bold print, enabling compressed mode, or even sending
  94. the string "DEAR SIR," to the printer.  The definition of each option is
  95. completely under your control, because you can customize your option
  96. menu (Section 4).
  97.  
  98. When finished selecting options, you can either hit <RETURN> to send
  99. the codes to the printer, or <ESC> to exit PPP with no action.
  100.  
  101. PPP107 Users Guide    --   Page 3
  102.  
  103.  
  104. Below is an example of a PPP main menu designed for use with the Toshiba
  105. P321 printer :
  106.  
  107.                      +============================+
  108. Title ------->       |    P321 Printer Control    |
  109.                      +----------------------------+
  110.                      |                            |
  111. Options ----->       |        > Eject Page        |
  112. (up to 16)           |          High Speed        |
  113.                      |          Quality Elite     |
  114.                      |          Quality Courier   |
  115.                      |          10.0 cpi          |
  116.                      |          12.0 cpi          |
  117.                      |          16.7 cpi          |
  118.                      |          Italics On        |
  119.                      |          Italics Off       |
  120.                      |          Bold On           |
  121.                      |          Bold Off          |
  122.                      |          "DEAR SIR,"       |
  123. F1 key brings up     |                            |
  124. Help Menu ---->      +========[ F1 - HELP ]=======+
  125.  
  126.  
  127.  2.3  The Help Menu
  128.  
  129. If you have trouble remembering what to do, pressing the F1 key will bring
  130. up a help menu screen.
  131.  
  132. This is the PPP Help screen :
  133.  
  134.  
  135.   +==========================================+
  136.   |   PPP Help Screen                        |
  137.   +------------------------------------------+
  138.   | <UP ARROW>Select previous option         |
  139.   | <DOWN ARROW>   Select next option        |
  140.   | <SPACE BAR>    Toggle highlighting       |
  141.   | <ESC>Exit without action                 |
  142.   | <RETURN>  Send highlighted commands      |
  143.   | to printer                               |
  144.   +------------------------------------------+
  145.   | F1   Change Hotkey                       |
  146.   | F2   Change Printer File                 |
  147.   +========[ Hit any key to exit help ]======+
  148.  
  149. This screen gives a short description of the keys used in the PPP main
  150. menu.  There are 2 functions which can be accessed from this menu, changing
  151. the hotkey (F1 key) and changing the current printer file (F2 key).
  152. Hitting any other key will return you to the main menu.
  153.  
  154. 2.3.1  The HotKey Menu
  155.  
  156. The HotKey menu appears if you press F1 from the Help menu.  The
  157. hotkey is the key, or combination of keys which causes PPP, in a resident
  158.  
  159. PPP107 Users Guide    --   Page 4
  160.  
  161.  
  162. mode, to appear on the screen.  The hotkeys which can be recognized by PPP
  163. are the function keys F3 through F10, <ALT> F1 through <ALT> F10, and
  164. <CTRL> F1 through <CTRL> F10.  The hotkey is unimportant when PPP is used
  165. as a nonresident utility.  The default hotkey used by PPP is <ALT> F8.
  166.  
  167. When the HotKey menu appears, hit the key combination that you want to
  168. invoke PPP.  Choose a combination which doesn't conflict with the software
  169. you use most often.  When you enter the new combination, the keyboard scan
  170. code for the chosen hotkey will appear on the menu for three seconds, and
  171. then control will return to the Main menu.If you enter the HotKey menu and
  172. decide not to change the current hotkey, press the <ESC> key.
  173.  
  174. To permanently change the hotkey, use the following table to determine the
  175. scan code for the desired hotkey, and edit this number into a batch file
  176. which starts PPP107 (Section 3).   PPP will only accept the key
  177. combinations defined in the table below.
  178.  
  179. HotKey  ScanCode   HotKey  ScanCode   HotKey  ScanCode
  180.  
  181. F1       RESERVED <CTRL> F1    94    <ALT> F1    104
  182. F2       RESERVED <CTRL> F2    95    <ALT> F2    105
  183. F3       61       <CTRL> F3    96    <ALT> F3    106
  184. F4       62       <CTRL> F4    97    <ALT> F4    107
  185. F5       63       <CTRL> F5    98    <ALT> F5    108
  186. F6       64       <CTRL> F6    99    <ALT> F6    109
  187. F7       65       <CTRL> F7   100    <ALT> F7    110
  188. F8       66       <CTRL> F8   101    <ALT> F8    111
  189. F9       67       <CTRL> F9   102    <ALT> F9    112
  190. F10      68       <CTRL> F10  103    <ALT> F10   113
  191.  
  192.  
  193. This is the PPP HotKey screen :
  194.  
  195.  +======================+
  196.  |  Hit Key Combination |
  197.  |    for New HotKey    |
  198.  |                      |
  199.  | Current Hotkey = 108 |
  200.  |                      |
  201.  | New Hotkey=          |
  202.  |                      |
  203.  +==[ <ESC> to Abort ]==+
  204.  
  205.  
  206.  2.3.2  The Printer Selection Menu
  207.  
  208. The Printer Selection menu appears if you press F2 from the Help
  209. menu.  This menu presents a list of all of the printer definition files
  210. (*.PPP) in the PPP default directory (where PPP was invoked).  The first
  211. printer listed appears in reverse video.  Use the up and down arrow keys to
  212. highlight a new printer, and hit <RETURN> to select the new printer.  PPP
  213. will default upon initialization to the first printer definition file it
  214. finds in the current directory.
  215.  
  216. PPP107 Users Guide    --   Page 5
  217.  
  218.  
  219. To permanently change the default printer definition file, edit the name of
  220. the file into the batch file which starts PPP (Section 3).
  221.  
  222. This is the PPP Printer Selection screen :
  223.  
  224.  
  225.                         +==========+
  226.                         | Printers |
  227.                         +----------+
  228.    Printer definition   | P321     |
  229.    files ------>        | EPSON    |
  230.                         | OKIDATA  |
  231.                         | CITIZEN  |
  232.                         +==========+
  233.  
  234.  
  235. 3.0  Command Line Switches
  236.  
  237. The default configuration of PPP can be modified by entering new defaults
  238. on the command line, preceded by "switches."  The command line switches
  239. recognized by PPP are defined as follows :
  240.  
  241. -R [or \R] nnn   --  This is the Residency switch.  If you want PPP to be a
  242. resident application, include this switch.  The default is non-resident.
  243. The "nnn" is the 3 digit hotkey which causes PPP to appear (Section 2.3.1).
  244.  
  245. -D [or \D] fname --  This is the Default printer configuration file name
  246. switch.  This switch tells PPP which printer configuration file to use.
  247. If this switch is omitted, PPP will find the first "PPP" file in the 
  248. directory.
  249.  
  250. -Q [or \Q]  --  This is the "quick" startup switch, and disables the
  251. startup screen.  PPP would be an impractical tool if you had to see my
  252. name all the time, but at least the first time you will see who wrote PPP.
  253.  
  254. Examples :
  255.  
  256. A>PPP -- invoke PPP, nonresident, default to first .PPP file
  257.  
  258. A>PPP -Q -R 108 -- invoke PPP, resident with <ALT> F5, no startup screen
  259.  
  260. A>PPP \Q \D EPSON -- invoke PPP, nonresident, default to EPSON.PPP
  261. configuration file, no startup screen
  262.  
  263. A>PPP -Q -R 103 -D P321 -- invoke PPP, resident with <CTRL> F10, default to
  264. P321.PPP configuration file, no startup screen
  265.  
  266. To simplify using PPP, you might want to create a batch file which starts
  267. the program, especially if you use one of the longer forms of the startup
  268. command.  Create this file with your ASCII text editor or with the COPY
  269. CON command.
  270.  
  271. PPP107 Users Guide    --   Page 6
  272.  
  273.  
  274. 4.0  Printer Definition Files
  275.  
  276. PPP is useless without a definition of control commands to send to the
  277. printer.  Each printer must have at least one printer definition file
  278. defining the control commands.  Printer definition files must have the
  279. extension .PPP, and they must exist in the directory from which PPP is
  280. invoked.  Printer definition files are in ASCII format, e.g. they can
  281. contain no control characters nor tabs.  When editing or creating a new
  282. printer definition file, edit your work using a "nondocument" mode, or
  283. use a straight ASCII editor, such as PC-Write.
  284.  
  285. The first line of a printer definition file contains the title.  This title
  286. appears in the PPP main menu.  The title cannot be more than 40 characters
  287. in length.
  288.  
  289. Examples :
  290.  
  291. P321 Printer Control
  292.  
  293. Mark's Special Control Menu
  294.  
  295.  
  296. The next sequence of lines defines the printer control options.  Each line
  297. defines a separate control option.  There can be up to 16 options in each
  298. file.  Each control option has two parts, the option name, and a sequence
  299. of decimal byte (< 256) values to send to the printer when that option is
  300. selected.  The option field occupies the first 40 characters of the line,
  301. and the byte values follow on the same line anywhere after column 40.
  302. There can be no additional spaces following the last control byte on a
  303. line.
  304.  
  305. Examples :
  306.  
  307. Option name  40                         Control bytes
  308.  
  309. Eject Page 12
  310.  
  311. 10.0 cpi                                27 42 48 27 69 49 50
  312.  
  313. "DEAR SIR,"                             68 69 65 82 32 83 73 82 44 13 10
  314.  
  315.  
  316. The last example above sends the string "DEAR SIR," to the printer.
  317.  
  318. After the last option line, the next line must contain a star (*),
  319. signifying the end of the printer definition file.
  320.  
  321. To find the control characters to use with your printer, consult your
  322. printer's manual.  Enter the characters, using their ASCII numbers, just
  323. as shown above.  Use the included .PPP files as examples to create your
  324. own personal printer control files. 
  325.  
  326. PPP107 Users Guide    --   Page 7
  327.  
  328.  
  329. Sample printer definition file for Toshiba P321 printer :
  330.  
  331. P321 Printer Control
  332. Eject Page                              12
  333. High Speed                              27 42 48
  334. Quality Elite                           27 42 49
  335. Quality Courier                         27 42 50
  336. 10.0 cpi                                27 42 48 27 69 49 50
  337. 12.0 cpi                                27 42 48 27 69 49 48
  338. 16.7 cpi                                27 42 48 27 69 49 48 27 91
  339. Italics On                              27 18
  340. Italics Off                             27 20
  341. Bold On                                 27 75 51
  342. Bold Off                                27 77
  343. "DEAR SIR,"                             68 69 65 82 32 83 73 82 44 13 10
  344. *
  345.  
  346. 5.0  Acknowledgements
  347.  
  348. This program would not have been possible were it not for the superior
  349. programming skill of the following individuals :
  350.  
  351. STAY-RES routines written by Lane H. Ferris of San Francisco, CA.  These
  352. public domain routines allowed me to make PPP a resident application.
  353.  
  354. Q SCREEN routines written by Jim LeMay of Ft. Worth, TX.  These routines
  355. sped up my screen displays tremendously.
  356.  
  357. My thanks to both of these individuals.
  358.  
  359. ----------------------------
  360. Editor's Note:
  361.  
  362. PPP107 can be installed as a memory-resident program when loaded with the -R
  363. switch.  Do not install it more than once in a computer session -- the program
  364. does not warn you when a copy already exists in memory. The only way to
  365. remove memory-resident programs is to reboot the computer.
  366.  
  367.     Conflicts sometimes exist between applications programs and
  368. memory-resident utilities, or between memory-resident programs themselves when
  369. two or more are simultaneously installed. If you experience difficulties,
  370. reboot the computer and install PPP107 alone.
  371.  
  372.     Memory-resident programs are also somewhat hardware dependent. While
  373. they may work on other systems, they may not work on yours. To avoid problems,
  374. test PPP107 with your applications programs and other memory-resident programs
  375. before you do any important work. It's wise to take this precaution when using
  376. any new memory-resident program for the first time.
  377.  
  378.